/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package eu.fastl.dragster.exception;

import eu.fastl.dragster.RegisteringBean;
import eu.fastl.dragster.aop.MonitoringAspect;
import eu.fastl.dragster.aop.MonitoringMethodInterceptor;
import eu.fastl.dragster.model.ExecutionRecord;
import eu.fastl.dragster.web.filter.MonitoringFilter;

/**
 * Interface for handling Exceptions caught by monitoring Objects like
 * {@link MonitoringFilter}, {@link MonitoringMethodInterceptor} or
 * {@link MonitoringAspect}
 *
 * @author Ernst Fastl
 */
public interface MonitoringExceptionHandler extends RegisteringBean{

    /**
     * Handle any exception caught by monitoring Advices or filters
     * @param exception the exception that has been caught
     * @param executionRecord the Record of the current execution
     * @throws Throwable ExceptionHandlers should be transparent and will typically re-throw the Exceptions
     */
    public void handleException(Throwable exception, ExecutionRecord executionRecord) throws Throwable;
}
